home *** CD-ROM | disk | FTP | other *** search
/ .net 2000 August / NET74.ISO / pc / Software / JavaApplet / AnfyMacBeta1.sea / Anfy for Macintosh / anjavapp / blur / anblur.txt < prev    next >
Encoding:
Text File  |  1999-07-05  |  6.2 KB  |  147 lines  |  [TEXT/ttxt]
  1.  
  2.           AnfyBlur - Copyright (C) by Fabio Ciucci 1997-99
  3.  
  4. INTRODUCTION.
  5.  
  6. This is an applet that can animate a sequence of GIF/JPG images (like
  7. other animators) but it also calculates the motion blur effect between
  8. frames. The appearance is that of a blur effect caused by speed in cameras.
  9.  
  10. Note: The GIF/JPG frames in the applet must be identical in size.
  11.  
  12. *****************************************************************
  13.  
  14. Apart from image files you specify, and an optional overlay image, the 
  15. following 2 ".class" files must be uploaded: 
  16.  
  17. anblur.class 
  18. Lware.class
  19.  
  20. Plus, anblur.jar for speedy loading on recent browsers.
  21.  
  22. ******************************************************************
  23.  
  24. EXAMPLE.
  25.  
  26. Insert the <applet> tag in your html document as follows to add this applet
  27. to your page (Comments after the ";" symbol are code explanations and
  28. acceptable min/max values. They are not part of the applet language):
  29.  
  30. <applet archive="anblur.jar" code="anblur.class" width="200" height="226">
  31. <param name="credits" value="Applet by Fabio Ciucci (www.anfyteam.com)">
  32. <param name="regcode" value="NO">            ; Register code (if you have it)
  33. <param name="reglink" value="NO">            ; URL link(optional) when clicked
  34. <param name="regnewframe" value="YES">       ; Reglink opened in new frame?
  35. <param name="regframename" value="_blank">   ; Name of new frame for reglink
  36. <param name="statusmsg" value="Blur applet"> ; Statusbar message
  37. <param name="imgs" value="anim/ani">         ; Animation to load
  38. <param name="format" value=".gif">           ; Suffix of frames
  39. <param name="nimgs" value="5">               ; Number of frames
  40. <param name="pingpong" value="YES">          ; Cyclic or Ping-Pong mode
  41. <param name="doublesize" value="YES">        ; Normal or double size.
  42. <param name="speed" value="100">             ; Play speed
  43. <param name="pingpause" value="1000">        ; Ping Pause
  44. <param name="pongpause" value="100">         ; Pong Pause
  45. <param name="audioping" value="audio/piccon.au"> ; Audio effect on Ping
  46. <param name="audiopong" value="NO">           ; Audio effect on Pong
  47. <param name="overimg" value="NO">             ; Optional image over applet
  48. <param name="overimgX" value="0">             ; Over image X offset
  49. <param name="overimgY" value="0">             ; Over image Y offset
  50. <param name="priority" value="3">             ; Task priority (1..10)
  51. Sorry, your browser doesn't support Java.     ; Msg in no java browsers
  52. </applet>
  53.  
  54. ***********************************************************************
  55.  
  56. CODE DESCRIPTIONS.
  57.  
  58. The following instructions describe how to change parameters:
  59.  
  60. Note: attempting to alter the "credits" parameter will disable the applet.
  61.  
  62. To activate the "reg" parameters, read the shareware registration notes.
  63. In the "regcode" parameter, place the registration code you
  64. purchased from the author. If the code is correct and the applet is run from
  65. the registered domain name, you can use "link" parameters to link to a URL
  66. when the applet is "clicked".
  67.  
  68. If you set "regnewframe" to "YES", you can specify a specific frame location
  69. for the reglink:
  70.  
  71. "_blank"  : To load the link in a new blank unnamed browser window.
  72. "_self"   : To load the link into the same window the applet occupies.
  73. "_parent" : To load the link into the immediate FRAMESET parent.
  74. "_top"    : To load the link into the top body of the window.
  75.  
  76. You can also set a custom frame name, such as "myframe1".
  77.  
  78. With the "overimg" parameter you can specify the name of an image that will
  79. be painted over the applet. The best options are transparent GIF images.
  80. NOTE: Animated GIF images are supported, but will be displayed as animated
  81. only on latest browsers (Netscape 4 and Explorer 4 or newer).
  82. With "overimgX" and "overimgY" you can center the image over the applet area.
  83.  
  84. The GIF and/or JPG images must all be the same size, however unlimited 
  85. dimensions. You can animate them at the original size, or zoom them *2,
  86. with "doublesize" parameter set to "YES". To do this, set the "width" 
  87. and "height" tags  with the doubled size of the frames.
  88.  
  89. For example, if frames are 100x113, you have to make width=200, height=223.
  90. Setting "doublesize" to "NO", will maintain the original size. (Enter the
  91. original size in "width" and "height" tags).
  92.  
  93. Note: when the format is .gif, DO NOT save any transparency coloru information.
  94.  
  95. The frames of animation can start with any prefix, but must end with the
  96. framenum (1,2,3,4...).
  97.  
  98. You can manually select the suffix (".gif" or ".jpg") with the "format"
  99. parameter.
  100.  
  101. The "imgs" parameter needs the prefix name of images, with an eventual
  102. path. For example, if images are named ani1.gif, ani2.gif, ani3.gif,
  103. and are placed in the anim/ subdirectory, you have to set parameters as
  104. follows:
  105.  
  106. <param name="imgs" value="anim/ani">
  107. <param name="format" value=".gif">
  108.  
  109. The "nimgs" parameter needs to know the number of frames.
  110.  
  111. There are two replay modes: "CYCLIC" and "PING PONG".
  112.  
  113. The cyclic mode simply plays the frames starting from the 1st to the
  114. last one, then restarts from the 1st one again: 1,2,3,4,5,1,2,3,4,5,1,2,3,4..
  115.  
  116. The ping pong mode plays from 1st to the last, then goes backwards to
  117. the first image, then reverses the direction of play. In other words: 
  118. 1,2,3,4,5,4,3,2,1,2,3,4,5,4,3,2,1,2,3,4.....
  119.  
  120. This mode is useful for some kind of movements, like the one in the
  121. animation example included.
  122.  
  123. Setting "pingpong" to "YES" enables ping pong mode, setting it to "NO"
  124. enables cyclic mode.
  125.  
  126. You can determine the speed of play with "speed" parameter. The value is
  127. expressed in microseconds. Usually the animation goes slower than the
  128. parameter to allow for drawing time.
  129.  
  130. The "pingpause" and "pongpause" parameters are the speed of the first and
  131. the last frames, and setting one or both of them higher than "speed" 
  132. parameter will cause a pause. This can be a creative effect; experiment 
  133. with it.
  134.  
  135. You can add sounds at the ping (first) and pong (last) frames by using
  136. "audioping" and "audiopong" parameters. To select a sound, place the name 
  137. of .au sample with the path. Otherwise enter "NO", this will disable the 
  138. audio feature.
  139.  
  140. Note: sounds can be only in Sun's .au format. If your program saves sound
  141. files only in .voc, .waw, or .iff formats, search for programs like Goldwave
  142. to convert them.
  143.  
  144. Remember to save sound files as 8000 Hz mono .au samples.
  145.  
  146.  
  147.